home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / utility / batrem32.zip / BATREM32.DOC < prev    next >
Text File  |  1994-01-28  |  38KB  |  921 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                            BatchReminder 3.02
  26.  
  27.                       Copyright (c) Nice SoftWare!
  28.  
  29.                    Postbus 6136, NL 2702 AC Zoetermeer
  30.  
  31.                              The Netherlands
  32.  
  33.                           FAX/PHONE +3179165841
  34.  
  35.                             FIDO 2:281/527.3
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.   BatchReminder 3.02 (C) Nice Software!             Page 2
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.   1. What is BatchReminder?...................................  3
  62.  
  63.   2. Installing BatchReminder.................................  3
  64.  
  65.   3. Data-entry into the diary................................  3
  66.        Calendar entries.......................................  4
  67.  
  68.   4. The diary-file : BATREM.FIL..............................  4
  69.  
  70.   5. How to use BatchReminder in AUTOEXEC.BAT.................  5
  71.        5a: Examples for use in AUTOEXEC.BAT...................  5
  72.        5b: Optional Path-instructions.........................  6
  73.        5c: Environment-instruction (SET-command):.............  6
  74.        5d: The ALARM-function ( also see section 12):.........  6
  75.  
  76.   6. Starting BatchReminder without a parameter...............  7
  77.  
  78.   7. Implementing BatchReminder in a MULTI-USER Environment...  8
  79.  
  80.   8. Address-maintenance in BatchReminder.....................  9
  81.        Mailmerge WP........................................... 10
  82.        Exporting data......................................... 10
  83.        Sorting................................................ 11
  84.  
  85.   9. The Utilities............................................ 11
  86.        Transfer............................................... 11
  87.        BackUp and Restore..................................... 11
  88.        SystemTime............................................. 11
  89.        BatchErase............................................. 12
  90.  
  91.   10. Manoevering BatchReminder............................... 12
  92.        Quick Keys............................................. 12
  93.        Operating the Calendar................................. 12
  94.  
  95.   11. Colours................................................. 13
  96.  
  97.   12. The TSR-program BatchAlarm (BATALARM.COM)............... 13
  98.        Technical data......................................... 14
  99.  
  100.   13. Disclaimer for BatchAlarm (BATALARM.COM)................ 15
  101.  
  102.   14. Maximum number of records in BatchReminders DIARY....... 15
  103.  
  104.   15. How about using BatchReminder permanently?.............. 16
  105.  
  106.   16. What happens if I do not register?...................... 16
  107.  
  108.   17. Credit where Credit is due.............................. 16
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.   BatchReminder 3.02 (C) Nice Software!             Page 3
  117.  
  118.  
  119.  
  120.  
  121.  
  122.   1. What is BatchReminder?
  123.   ─────────────────────────
  124.  
  125.   BatchReminder is a 'Personal Information Manager' or 'Organizer' for the
  126.   PC. The program enables you to maintain a DIARY and ADDRESS-bank.
  127.   The DIARY has a built-in REPORTER and ALARM-clock which enables you to see
  128.   DIARY-events on screen instantaneously, on a daily basis.
  129.   The resident part of the ALARM-function is a mere 1600 bytes in size
  130.   allowing you full benefit of precious DOS base memory. This makes it one of
  131.   the smallest memory resident DIARY-utilities ever.
  132.  
  133.   ADDRESS-control offers you the ability to store all the addresses of your
  134.   personal relations in a file on disk.
  135.   With the option 'MAIL-MERGE WP', you can produce a 'secondary file' which
  136.   you can combine in a WordPerfect document for mail-merging purposes.
  137.  
  138.   The export functions of ADDRESS-control carry your data within the reach of
  139.   dBASE, LOTUS 123 and wordprocessor.
  140.  
  141.   BatchReminder can also be implemented in a multi-user network.
  142.   In a network BatchReminder can be tailored to honour data- and user-
  143.   directories. This makes it possible to report from a central and a private
  144.   diary.
  145.   Through the ALARM-function a network administrator can even reach users who
  146.   logged off during the day!
  147.  
  148.   2. Installing BatchReminder
  149.   ───────────────────────────
  150.  
  151.   The installation of BatchReminder can be achieved by running INSTALL.EXE.
  152.   INSTALL copies the BatchReminder files to the correct directory (creates it
  153.   if necessary) and will optionally edit AUTOEXEC.BAT for an optimal use of
  154.   BatchReminder. The original AUTOEXEC.BAT is renamed to AUTOEXEC.OLD so you
  155.   can return to the old situation any time you choose.
  156.  
  157.   As a matter of fact you can skip the technical stuff under section 5 and 7
  158.   when you use the install program. Install will construct the right syntax
  159.   from your answers to the prompts of install.
  160.  
  161.   3. Data-entry into the diary
  162.   ───────────────────────────
  163.  
  164.   Initially BatchReminder knows eight default diary-events:
  165.  
  166.   - Diary
  167.   - Pinboard
  168.   - Birthday
  169.   - Wedding-day
  170.   - Anniversary
  171.   - Lustrum
  172.   - Foundation
  173.   BatchReminder 3.02 (C) Nice Software!             Page 4
  174.  
  175.  
  176.  
  177.  
  178.  
  179.   You are free to change this events in the data-entry procedure. These
  180.   changes are written to the configuration file. In this way you can tailor
  181.   the events to your needs.
  182.  
  183.   When entering a date you are free to omit the year. This is particularly
  184.   useful with birthdays when you know the day and month but not the exact
  185.   year.
  186.  
  187.   Pinboard entries are reminders for things to do for which no particular
  188.   date is (yet) planned. Pinboard entries are therefore the only events
  189.   WITHOUT a date and are reported daily by BatchReminder.
  190.  
  191.   A single event can either be reported yearly or just once.
  192.   One-time events are exclusively reported on the exact date and for as much
  193.   as they fall within the user-defined reach of the search-parameter.
  194.  
  195.   Yearly events are reported on the exact day and month and for as much as
  196.   they fall within the reach of the search-parameter (see section 5).
  197.  
  198.   Calendar entries
  199.   ================
  200.  
  201.   The calendar-function brings the current month on screen with the cursor on
  202.   the current day. Days with events or set alarm are indicated as such.
  203.   On the right-hand side of the calendar the contents of the day are
  204.   presented in the diary-window. With the aid of the cursor-keys one can
  205.   scroll to different days and months.
  206.   Note that the calendar gives an extra possibility to record diary-events. 
  207.   The calendar routine however regards all entries as 'one-time' events and
  208.   doesn't accept passed dates.
  209.  
  210.   The calendar is suited to consult the diary quickly to see if an
  211.   appointment can be made and to fix it in the progress.
  212.  
  213.   A periodical returning event is most efficiently recorded by:
  214.        
  215.        - Entry the first event ( Standard or through Calendar)
  216.        - Select 'carry through' under option 'Mutations :
  217.          Change' and set:
  218.             - The end-date of the series of events
  219.             - The time-factor: day, week, month, year
  220.             - The skip-factor
  221.  
  222.   4. The diary-file : BATREM.FIL
  223.   ───────────────────────────────
  224.  
  225.   Diary entries are stored by BatchReminder in a file called 'BATREM.FIL'.
  226.   BatchReminder 3.02 (C) Nice Software!             Page 5
  227.  
  228.  
  229.  
  230.  
  231.  
  232.   Owners of an old release of BatchReminder must make sure to rebuild the old
  233.   BATREM.FIL with the programm REBUILD.EXE to make it fit for use with
  234.   release 3.02. BatchReminder is capable of detecting an old file-layout and
  235.   will tell you the moment you try to make a change to the data-base.
  236.  
  237.   5. How to use BatchReminder in AUTOEXEC.BAT
  238.   ────────────────────────────────────────────
  239.  
  240.   NB!  This technical stuff is fully supported by the install programme
  241.        INSTALL.EXE. Knowledge of the parameter-use therefore is not
  242.        essential. This document however would not be complete if this
  243.        subject was not disclosed.
  244.  
  245.   To use BatchReminder in a BATCH-procedure one needs to place BatchReminder
  246.   parameters in the BATCH-File, e.g.
  247.  
  248.        BATREM option [-Ffullpath] [-Dfullpath]
  249.  
  250.   The path-instructions are optional for special use in Batch-files, if no
  251.   parameter is supplied BatchReminder will present a well-come window
  252.   followed by a pull-down menu.
  253.  
  254.   Valid options:
  255.        Z         = Search and report today's events
  256.        Zn        = Search and report today and n-days back (max 9)
  257.        ZM        = Search and report today, on mondays 2 days back
  258.        Z[n][M]Vn = As above plus n-days ahead (max 9)
  259.        1Z[n][M]Vn= As above, only once a day
  260.        Z[nMVn]Cx = x is colour Reporterscreen (1 to 15)
  261.  
  262.   5a: Examples for use in AUTOEXEC.BAT
  263.   =====================================
  264.   ..........
  265.   BATREM Z       => Every time at reboot report about today's events
  266.   BATALARM
  267.  
  268.   ..........
  269.   BATREM 1ZMC01  => Advised parameter, once a day, on Mondays 2 days back,
  270.   BATALARM          Reporter screen-colour is 01 (Blue)
  271.  
  272.   ..........
  273.   BATREM 1ZMV1   => As above, but also looks 1 day ahead
  274.   BATALARM
  275.  
  276.   ..........
  277.   BATREM 1Z9V9   => once a day, 9 days back, 9 days ahead (full scope)
  278.   BATALARM  
  279.  
  280.   BatchReminder 3.02 (C) Nice Software!             Page 6
  281.  
  282.  
  283.  
  284.  
  285.  
  286.   5b: Optional Path-instructions
  287.   ==============================
  288.  
  289.   There is no need to place BATREM.EXE and its database BATREM.FIL together
  290.   in the same directory.
  291.   BatchReminder first looks in the current directory and will, if necessary,
  292.   search the entire DOS-path for BATREM.FIL.
  293.    
  294.   The working files of BatchReminder can be placed in different directories.
  295.   This is particularly useful in a multi-user network (also see section 7),
  296.   e.g.
  297.  
  298.        DATA-files     F:\PZ\DATA     (*.FIL)    
  299.        User unique-   F:\USER\JOHNSON(*.CFG, *.FRQ, *.ALM)
  300.         files         
  301.  
  302.   In this situation one uses the optional path-instructions:
  303.  
  304.   Example in AUTOEXEC.BAT:
  305.  
  306.   ........
  307.   BATREM 1ZM -DF:\PZ\DATA -FF:\USER\JOHNSON
  308.   BATALARM -FF:\USER\JOHNSON
  309.  
  310.   5c: Environment-instruction (SET-command):
  311.   ==========================================
  312.  
  313.   Apart from making use of the -D or -F parameter it is possible to globally
  314.   indicate where BatchReminder can find its files.
  315.  
  316.   This is done by means of the SET-command in AUTOEXEC.BAT just before
  317.   BatchReminder is called, e.g.
  318.  
  319.        SET BATREM= C:\UTILS\BATREM
  320.        BATREM 1ZMV1
  321.  
  322.   BatchReminder will now expect its files to be located in the directory 
  323.   C:\UTILS\BATREM.
  324.  
  325.   However, the explicit use of -D or -F will overrule the SET command.
  326.  
  327.   *** The default size of the DOS-environment is 160 bytes.    ***
  328.   *** If no more environment space is available for the SET    ***
  329.   *** instruction one can enlarge this environment-block by    ***
  330.   *** entering the following instruction in CONFIG.SYS:        ***
  331.   ***                     SHELL = C:\COMMAND.COM /P /E:512     ***
  332.  
  333.   5d: The ALARM-function ( also see section 12):
  334.   ==============================================
  335.  
  336.   The ALARM-time (24 hour format) is optional and activates two functions
  337.   within BatchReminder,
  338.   1.   Guarding against double appointments; if an appointment is entered
  339.        BatchReminder will not accept another appointment for the given time.
  340.   BatchReminder 3.02 (C) Nice Software!             Page 7
  341.  
  342.  
  343.  
  344.  
  345.  
  346.   2.   ALARM-signal function; on the given time one hears the Reporter-bell
  347.        and furthermore a message appears in the right top corner of the
  348.        screen.
  349.        Note that this function only works in conjunction with the TSR-
  350.        utility BatchAlarm!
  351.        BatchReminder and BatchAlarm communicate by means of an interface-
  352.        file 'C:\~~~1.ALM' which is produced by BatchReminder and is read by
  353.        BatchAlarm.
  354.        ( Pay attention to the calling sequence in the Batch-file!)
  355.  
  356.   If you don't want to use the TSR you can switch off the ALARM-interface by
  357.   means of the menu-option 'Config'.
  358.  
  359.   6. Starting BatchReminder without a parameter
  360.   ──────────────────────────────────────────────
  361.  
  362.   If BatchReminder is started without a parameter, it presents a welcome-
  363.   window followed by a pull-down menu:
  364.  
  365.   MUTATIONS :    Entry     - new diary event
  366.                  Change    - Name, date, event, frequency,
  367.                              Carry through
  368.                  Remove    - remove passed or unwanted events
  369.                  BatchErase- Remove passed 'one-time' events ; result
  370.                              to BATREM.HIS
  371.                  End       - Exit to DOS
  372.  
  373.   DIARY      :   Today     - Report today's events
  374.                  LookBack  - Events from Jan 1th till today
  375.                  LookAhead - Coming events
  376.                  Print     - Full Report per item to printer
  377.                  Calendar  - Month(s) on screen with fast entry
  378.  
  379.   INFO      :    Help      - General directions
  380.                  Info      - Philosophy and Credits
  381.                  Licence   - Licence-information
  382.  
  383.   CONFIG    :    Colour    - Reporter and BatchReminder in colour
  384.                  Monochrome- Reporter and BatchReminder in B/W
  385.                              (monochrome C/E/VGA)
  386.                  Sound On  - 'Whistling Windows' at welcome and 
  387.                              file-mutations
  388.                  Sound Off - Silence. Doesn't silence Reporter-bell
  389.                  MakeAlarm - Enables interfacing with BatchAlarm
  390.                  MakeNoAlarm- You like BatchReminder but resent the use
  391.                              of TSR's. No interface will be made.
  392.   BatchReminder 3.02 (C) Nice Software!             Page 8
  393.  
  394.  
  395.  
  396.  
  397.  
  398.   ADDRESSES :    Consult   - Consult the address-bank with several
  399.                              search-facilities (sound, string etc)
  400.                  Entry     - New addresses
  401.                  Change    - change existing entries
  402.                  Remove    - remove existing entries
  403.                  Mail-Merge- Produce secondary file for WordPerfect
  404.                  Export    - Export address-bank to dBase III, LOTUS 123
  405.                              or ASCII
  406.                  Sort      - Sort address-bank on 1 of more items
  407.  
  408.   UTILITIES :    Transfer  - Automatic exchange of BatchReminder 
  409.                              DATA-files between 2 PC's by means of
  410.                              DATE/TIME comparison
  411.                  BackUp    - Copy DATA-files to diskette
  412.                  Restore   - Copy DATA-files from diskette
  413.                  Hows&Why  - Explanatory discourse on Utilities
  414.                  SystemTime- Correct DOS time and day
  415.  
  416.   QUIT      :    ExitToDos - Exit to DOS
  417.  
  418.   7. Implementing BatchReminder in a MULTI-USER Environment
  419.   ──────────────────────────────────────────────────────────
  420.  
  421.   NOTE!The technique which is described in this section is fully applied by
  422.        the install-program INSTALL.EXE. In most of the cases INSTALL will
  423.        construct the correct parameter syntax. So reading this technical
  424.        stuff is not a must. This documentation however would not be complete
  425.        if the 'MULTI-USER' aspect was to be omitted. 
  426.        In some cases the installation in a network requires an in depth
  427.        approach. A total grasp of this section is then essential.
  428.  
  429.   A number of users have implemented BatchReminder on a SERVER in a network
  430.   and have sent me enthusiastic reactions. 
  431.  
  432.   On the CLIENT side (workstations) the following adjustments should be made
  433.   to AUTOEXEC.BAT,
  434.  
  435.   a:   SET BATREM = C:\UTILS\BATREM (or whatever directory you see fit)
  436.  
  437.        This instructs BatchReminder to read the configuration- and
  438.        frequency-file of the individual CLIENT. If you omit the SET-command
  439.        BatchReminder would try to write to the root of the SERVER where it
  440.        hasn't got write-permission (amongst other draw-backs).
  441.  
  442.   b:        BATREM 1ZM -DF:\PZ\DATA
  443.             BATALARM
  444.  
  445.        The use of the -D parameter forces BatchReminder to use the data-file
  446.        on the SERVER and causes the ENVIRONMENT-parameter to be ignored.
  447.   BatchReminder 3.02 (C) Nice Software!             Page 9
  448.  
  449.  
  450.  
  451.  
  452.  
  453.   The ALARM-interface '~~~1.ALM' is by default created in the ROOT of drive C
  454.   by BatchReminder. When this is not allowed ( or not possible : think of
  455.   diskless workstations ) the F-parameter should be used to indicate the
  456.   user's home-directory on the SERVER. With the same -F parameter BatchAlarm
  457.   must be instructed where to look for the interface-file, thus
  458.  
  459.             BATREM 1ZM -FH:\USER\JOHNSON
  460.             BATALARM -FH:\USER\JOHNSON
  461.  
  462.   or in combination with the -D parameter
  463.                                     
  464.             BATREM 1ZM -DF:\PZ\DATA -FH:\USER\JOHNSON
  465.             BATALARM -FH:\USER\JOHNSON
  466.  
  467.   During write-actions to the SERVER a complete write-lock is enforced on
  468.   'BATREM.FIL' in order to prevent file-inconsistency.
  469.   So called 'dead-locks' are intercepted whereby the CLIENT is allowed to
  470.   choose to wait and try again or to break off the procedure.
  471.  
  472.   *** The code that supports 'filesharing' and 'locking' in a network ***
  473.   *** environment is isolated in the user installable SHARE-module    ***
  474.   *** from MS-DOS. After SHARE is loaded MS-DOS will monitor all      ***
  475.   *** reading and writing actions through this module.                ***
  476.  
  477.   If and when a CLIENT is not permitted to make changes to the data-base
  478.   a 'read-only' status on the SERVER-file should be attributed thus
  479.   preventing unauthorised changes to the file.
  480.  
  481.   If BatchAlarm is added to the CLIENT side the network-administrator has a
  482.   possibility to invoke messages on all workstations for a given moment.
  483.   Logging off from the network could not prevent this since BatchAlarm stays
  484.   resident until the workstation is switched off. Even rebooting would not
  485.   interfere with the message because BatchAlarm would find the interface file
  486.   at boot-up and go resident again.
  487.  
  488.   The SET-parameter makes it possible for the CLIENT to maintain a separate
  489.   BATREM.FIL for personal use. In AUTOEXEC.BAT BatchReminder will then be
  490.   called for a second time, this time without the -D parameter.
  491.  
  492.   8. Address-maintenance in BatchReminder
  493.   ────────────────────────────────────────
  494.  
  495.   This is all very straightforward. Here are some useful tips for the data-
  496.   entry of addresses,
  497.  
  498.   -FIRSTNAME     :    Something like Family B.
  499.                                 or Henry van => rest with NAME
  500.                                 or Karen and Rob
  501.   -NAME          :    Family or Company-name
  502.   BatchReminder 3.02 (C) Nice Software!             Page 10
  503.  
  504.  
  505.  
  506.  
  507.  
  508.   -MAILADDRESS   :    If a persons mailing-address is the same as his
  509.                       HOME-ADDRESS it is not necessary to enter the same
  510.                       data twice. Make sure however that MAIL-ADDRESS is
  511.                       always used in order to prevent problems with
  512.                       MAILMERGE.
  513.   -MAILLIST      :    Choose a short indication like, Private, Xmas etc
  514.                       Since the address-bank has not got a country input
  515.                       field you also could use this field for country 
  516.                       indications.
  517.  
  518.   Mailmerge WP
  519.   ============
  520.  
  521.   This option enables you to arrange large mailings and/or to produce labels.
  522.   'Mailmerge' creates a secondary file for special use with WordPerfect, in
  523.   which all variables for a document or label are included.
  524.  
  525.   ( NOTE ; in case you don't posses WordPerfect but own a different
  526.   wordprocessing package it will no doubt be possible to make a mailmerge
  527.   file by means of exporting to dBase or LOTUS and importing this in your
  528.   personal wordprocessor)
  529.  
  530.   It makes no difference if you do mail-merge or print labels, for
  531.   WordPerfect you need two files, a 'primary' file and a 'secondary' file.
  532.   The secondary file contains the actual varying data and is produced by
  533.   BatchReminder. You just pick the data in the order that is expected by the
  534.   primary file.
  535.  
  536.   The primary file you make yourself with WordPerfect and could look like
  537.   this:
  538.  
  539.        To             : {FIELD}1~         ==>Shift-F9,1,1,Enter
  540.        Street         : {FIELD}2~         ==>Shift-F9,1,2,Enter
  541.        Zipcode and City : {FIELD}3~ {FIELD}4~==>etc.
  542.  
  543.   The contents of these 4 fields are actually ready in the secondary file.
  544.   In Wordperfect one combines the two files with CTRL-F9. Just make sure you
  545.   don't mix up the field- and record-separators [ ] and { }.
  546.  
  547.   If you are to print labels you should first define the label-form in
  548.   WordPerfect (SHIFT-F8,2,7, Add, Labels).
  549.   With a ruler for the label dimensions and a small dose of insight this feat
  550.   can easily be accomplished.
  551.  
  552.   To take this burden off your hand, a WP-MACRO 'AVERY.WPM' is supplied with
  553.   BatchReminder. This handy macro will define labelforms for both matrix- and
  554.   laserprinters. You will of course be needing 'AVERY'-labels but that was
  555.   the whole idea behind writing this macro in the first place. AVERY-labels
  556.   come in packages of 25, 50 or 100 sheets.
  557.  
  558.   Exporting data
  559.   ==============
  560.   Users of dBASE or LOTUS 123 will surely appreciate the possibility to
  561.   process the addressing-data in the named software-packages. For this reason
  562.   the complete address-file can be exported in the format of your choosing.
  563.   BatchReminder 3.02 (C) Nice Software!             Page 11
  564.  
  565.  
  566.  
  567.  
  568.  
  569.   Any further record- or fieldselections are left to dBASE or LOTUS.
  570.  
  571.   When exporting to ASCII one must indicate WHICH fields should be
  572.   transformed. Bear in mind that selection of all fields will make the ASCII-
  573.   file to be too long in row-size and probably cause a truncation at import.
  574.  
  575.   Sorting
  576.   =======
  577.  
  578.   On the address-file NO special tricks like pointers or indexes have been
  579.   applied. A new record is simply added at the end of the current file.
  580.   With the sort option you are completely free to sort the file on any
  581.   indication you see fit. For instance on ZIP-code or on CITY. 
  582.  
  583.   9. The Utilities
  584.   ─────────────────
  585.  
  586.   Transfer
  587.  
  588.   This is particularly useful when you use BatchReminder on 2 separate
  589.   computers, e.g. one at work and one at home. 
  590.   TRANSFER compares the BatchReminder data-files on hard disk with those on a
  591.   diskette in drive A, this on a basis of file time and date.
  592.   When the files on hard disk are more recent than those on diskette ( or
  593.   nonexistent on diskette), BatchReminder copies the data to the diskette.
  594.   In the situation where the hard-disk files are older than the ones on
  595.   diskette, it goes the other way around. 
  596.   Through this you can travel around with your personal data on diskette and
  597.   need not ask yourself which way you have copy this time.
  598.  
  599.   BackUp and Restore
  600.  
  601.   Copies the data-files BATREM.FIL and BATADRES.FIL to or from diskette.
  602.  
  603.   SystemTime
  604.  
  605.   'Let's synchronize our watches' is an amply used film-expression. To make
  606.   sure that the system-clock is equal to yours, this utility is at hand to
  607.   correct the system time and day to real time.
  608.   Experience learns that system-time lives a life of its own in the long run.
  609.   Because of this you could miss appointments when BatchAlarm gives a signal
  610.   at his time, not necessarily yours.
  611.  
  612.   NOTE! It is pointless correcting the system-time after BatchAlarm has gone
  613.        resident. (This is reported in the BatchReminder bottom status-bar).
  614.        BatchAlarm follows a count-down cycle and doesn't do any real-time
  615.        checks after it has gone resident. If you were to change the
  616.        system-time in such a case you should first unload BatchAlarm and 
  617.        reload it again after the time correction.
  618.   BatchReminder 3.02 (C) Nice Software!             Page 12
  619.  
  620.  
  621.  
  622.  
  623.  
  624.   BatchErase
  625.  
  626.   With this utility you can quickly dispose of all one-time events in the
  627.   DIARY that lie in the past and therefore are dead-weight for the Reporter.
  628.   Removed entries are written to a historical file BATREM.HIS in ASCII-
  629.   format. This enables you to browse this historical data with a
  630.   wordprocessor.
  631.  
  632.   10. Manoevering BatchReminder
  633.   ──────────────────────────────
  634.  
  635.   The 'pull-down' menu is ACTIVATED by pressing the ALT-key. Quick-keys give
  636.   fast access to a menu-option. These quick-keys however are not operative
  637.   once the menu-bar is activated.
  638.  
  639.   <Buttons> can be activated by placing the cursor on the button and pressing
  640.   ENTER or can be clicked by the mouse.
  641.   The <TAB> Button in the DIARY entry-screen can be activated by the TAB-key,
  642.   by the cursor/ENTER combination or by clicking it with the mouse.
  643.  
  644.   Quick Keys
  645.   ==========
  646.  
  647.   As long as the menu-bar is NOT activated some functions can be quickly
  648.   called by pressing the following function-keys:
  649.  
  650.        F1= help                 F6= Consult addresses
  651.        F2= Entry screen DIARY   F7= Entry screen addresses
  652.        F3= Change DIARY entries F8= Change addresses
  653.        F4= Remove DIARY entries F9= Remove addresses
  654.        F5= Calendar             F10= Exit to DOS
  655.  
  656.   Operating the Calendar
  657.   ======================
  658.   Mouse:    Select a day by clicking it with the mouse. A function of a 
  659.             <Button> is called by clicking it with the mouse.
  660.             After selection of the desired date, the adjacent DIARY-window
  661.             may be clicked on. The contents of the day will appear on
  662.             screen. In this situation a new DIARY-event may be entered by
  663.             clicking on the <Input> button.
  664.             Note that only one-time events will be entered with DIARY as
  665.             fixed subject.
  666.             If you need to enter a yearly event, you may now either press
  667.             F2 (Quick-Key) or choose menu-option 'Mutations: Entry' whilst
  668.             the DAIRY-window is still on screen. Your chosen date then
  669.             appears in the DIARY-entry screen as default-value.
  670.             While in Calendar-mode you can swap windows by clicking on the
  671.             desired window.
  672.   BatchReminder 3.02 (C) Nice Software!             Page 13
  673.  
  674.  
  675.  
  676.  
  677.  
  678.   Keyboard: Select a day with the cursor-keys. A function of a <Button> is
  679.             called by pressing the indicated key on the keyboard. 
  680.             After selection of the desired date ENTER may be pressed.
  681.             The contents of the day will appear on screen. In this
  682.             situation a new DIARY-event may be entered by selecting the
  683.             <Input> button.
  684.             Note that only one-time events will be entered with DIARY as
  685.             fixed subject.
  686.             If you need to enter a yearly event, you may now either press
  687.             F2 (Quick-Key) or choose menu-option 'Mutations: Entry' with
  688.             the ALT-M key combination. Your chosen date then appears in the
  689.             DIARY-entry screen as default value.
  690.             While in Calender-mode you may swap windows with the aid of the
  691.             <Buttons>.
  692.  
  693.   11. Colours
  694.   ────────────
  695.  
  696.   BatchReminder checks your video-card for the capability of handling more
  697.   than 4 colours in text-mode and will automatically switch to colour. If
  698.   this is not wanted ( monochrome CGA/EGA/VGA ), colour setup may be
  699.   overruled by selecting 'Config: Monochrome' from the menu-bar.
  700.   BatchReminders configuration is logged to the file BATREM.CFG.
  701.  
  702.   The colour of the Reporter-screen may be set in the Batch-procedure by
  703.   means of the Cx-parameter, where x is a figure from 1 to 8:
  704.  
  705.             C01       Blue
  706.             C02       Green
  707.             C03       Cyan
  708.             C04       Red
  709.             C05       Magenta
  710.             C06       Brown
  711.             C07       White
  712.             C08       Grey
  713.  
  714.   Example:  BATREM 1ZMC07  or : BATREM 1ZMC04
  715.  
  716.   Giving a colour-code is not mandatory. When the Cx parameter is not found
  717.   BatchReminder will switch to default ( blue or white ).
  718.  
  719.   12. The TSR-program BatchAlarm (BATALARM.COM)
  720.   ─────────────────────────────────────────────
  721.  
  722.   BatchAlarm was written on special request by users who kept on forgetting
  723.   the Reporter-information in de course of the day. Losing all track of time
  724.   as they where deeply immersed in their every day work. In short, they
  725.   wanted an alarm-function on screen.
  726.  
  727.   BatchAlarm (BATALARM.COM) was conceived for this purpose and is fully
  728.   written in Assembler, the language the computer knows best. This TSR should
  729.   be regarded as an 'add-on' to BatchReminder. You need this program when you 
  730.   want to hear a signal and see a pop-up message on screen on a preset time.
  731.   BatchReminder 3.02 (C) Nice Software!             Page 14
  732.  
  733.  
  734.  
  735.  
  736.  
  737.   BatchReminder and BatchAlarm communicate through the interface-file
  738.   '~~~1.ALM' which is optionally created by BatchReminder and is by default
  739.   to be found in the root-directory of drive C.
  740.  
  741.   If this is unwanted ( or impossible: think of diskless workstations) the F-
  742.   parameter should point to the alternative directory. With the very same
  743.   parameter BATALARM.COM must be instructed where to look for its interface-
  744.   file ( see the example in section 7).
  745.  
  746.   The ALARM-function works as follows:
  747.  
  748.   After you have indicated by selecting 'CONFIG : MakeAlarm' that the ALARM-
  749.   function should be switched on, BatchReminder in BatchMode will check for
  750.   alarm-events for the current day. If alarm-events are found BatchReminder
  751.   writes the alarm-time and alarm-message to the interface-file '~~~1.ALM'.
  752.   If no alarm-events are found the interface-file will not be created but
  753.   erased when found on disk.
  754.  
  755.   Subsequently BatchAlarm will check for the existence of the interface-file.
  756.   When found, BatchAlarm will read the contents and go resident with the
  757.   file-information. ( Make sure to call BatchAlarm first with the correct
  758.   parameters in AUTOEXEC.BAT before you invoke BatchAlarm).
  759.  
  760.   *** Because of the alarm-function the correctness of the system-time ***
  761.   *** is most essential. For this reason a function-key is designed    ***
  762.   *** in the Reporter-screen (F5) which enables you to correct the     ***
  763.   *** system time BEFORE BatchAlarm goes resident. When you make       ***
  764.   *** changes to the set system DATE the Reporter will restart again   ***
  765.   *** in order to give the right information.                          ***
  766.  
  767.   On the preset time BatchAlarm will break through the current application.
  768.   The Reporter-bell will sound and your particular appointment will appear in
  769.   red in the right-hand top corner of the screen. ( When a screen is in
  770.   graphic-mode you just hear the Reporter-bell). 
  771.   The message will appear for 10 seconds every minute and will be stopped
  772.   after pressing the ALT-key. During these 10 seconds the keyboard will
  773.   not accept input, other than the ALT-key.
  774.   BatchReminder will then proceed to the count-down of further alarm-events
  775.   (max 10).
  776.   BatchAlarm stays resident until it is deinstalled with 'BATALARM U' or
  777.   until the PC is rebooted. When the computer is rebooted before all alarm-
  778.   events have passed, BatchAlarm will automatically go resident again with
  779.   the remaining alarm-events.
  780.  
  781.   Technical data
  782.   ==============
  783.  
  784.   BATALARM.COM 'hooks' Interrupt 1CH (Timer Tick).
  785.  
  786.   * BATALARM.COM also calls the old interrupt vector thus honouring other
  787.   * TSR's that depend on interrupt 1CH. Pay attention however to the fact that
  788.   * not every TSR-programmer follows this rule. If you find that BatchAlarm is
  789.   * disabled by selfish TSR's, load them first before loading BatchReminder.
  790.  
  791.   During initialisation BatchAlarm calculates the remaining seconds for all
  792.   alarm-events (max 10) and goes resident with them. After approximately 18
  793.   timer-ticks BatchAlarm descends 1 second in the count-down cycle.
  794.   When zero is reached BatchAlarm sounds the Reporter-bell and checks the
  795.   screen for text- or graphic-mode. It won't touch graphic screens but you
  796.   will hear the Reporter-bell. In text-mode it saves the back-ground
  797.   information of the top screen row and restores it after the message-time
  798.   has passed.
  799.   BatchReminder 3.02 (C) Nice Software!             Page 15
  800.  
  801.  
  802.  
  803.  
  804.  
  805.   DURING A SCREEN-MESSAGE THE KEY-BOARD INTERRUPT IS DISABLED TO PREVENT
  806.   the user from making a screen-change before the original screen is
  807.   restored.
  808.   The resident part of BatchAlarm is a mere 1600 bytes in size, thus making
  809.   it one of the smallest memory resident DIARY-utilities.
  810.  
  811.  
  812.   13. Disclaimer for BatchAlarm (BATALARM.COM)
  813.   ─────────────────────────────────────────────
  814.  
  815.   BatchAlarm was kept very simple so it would use very little DOS-memory.
  816.   This simplicity also brings about limitations. Although the programme has
  817.   been tested by me and the test-team on various machines, I cannot give you
  818.   any guarantee that this TSR will work flawlessly. (It has been known to
  819.   hang up dedicated servers running under NOVELL when installed BEFORE 
  820.   the NOVELL-software was installed). 
  821.   Please test it on your own configuration to make sure it causes no
  822.   problems.
  823.  
  824.   BatchAlarm is a 'add-on' to BatchReminder and therefore not essential for
  825.   the operation of BatchReminder itself. 
  826.   When in doubt, or when problems should occur, simply switch off the
  827.   interface with 'CONFIG: MakeNoAlarm' and remove BATALARM.COM from
  828.   AUTOEXEC.BAT. In that case the ALARM-function is restricted to signalling
  829.   double appointments at entry. The Reporter will of course do its duty
  830.   anyway.
  831.  
  832.   14. Maximum number of records in BatchReminders DIARY
  833.   ──────────────────────────────────────────────────────
  834.  
  835.   In order to keep the processing-speed of BatchReminder optimal, I have
  836.   decided to perform sorting-routines completely in memory (thus sparing
  837.   disk-IO). Also for the sake of the Reporterspeed at boot-up, there was a
  838.   necessity to put limitations to the size of the DIARY-file 'BATREM.FIL'.
  839.   The upper-border of this release 3.02 is absolutely fixed on 1800 events.
  840.   From 1750 events on BatchReminder will start to warn that the ceiling is
  841.   about to be reached. With the aid of the BatchErase utility (MUTATIONS,
  842.   BatchErase) you can quickly dispose of all passed one-time events that now
  843.   are a dead loss to the Reporter. BatchErase will move these events to a
  844.   historical file on disk (BATREM.HIS) in ASCII-format.
  845.  
  846.   It is highly recommended to perform BatchErase on a regular basis as to
  847.   keep the performance of BatchReminder on a giddy hight.
  848.  
  849.   This restriction was not imposed on the address-file BATADRES.FIL. The
  850.   maximum size of this file is related to the available size on disk.
  851.   Sorting of the address-file goes by means of DISK-IO. Sorting a large file
  852.   may therefore take some time.
  853.   BatchReminder 3.02 (C) Nice Software!             Page 16
  854.  
  855.  
  856.  
  857.  
  858.  
  859.   15. How about using BatchReminder permanently?
  860.   ──────────────────────────────────────────────
  861.  
  862.   BatchReminder is a SHAREWARE product. This means that you may try out this 
  863.   program for a given time. You are also encouraged to upload this program
  864.   or pass it on to friends so they might try it as well.
  865.   However, if you still use the programme after a month you are expected to
  866.   pay for it.  
  867.  
  868.   Registering BatchReminder entitles you to receive a diskette with the
  869.   most recent version of BatchReminder, registered to your name.
  870.  
  871.   As a registered user you are allowed to install BatchReminder on two PC's
  872.   to your choosing, e.g. one at home and one at work.
  873.  
  874.   A multi-user receives the right (and the possibility) to implement
  875.   BatchReminder in a multi-user environment.
  876.  
  877.   Registering gives you the right to free updates as they come out, against
  878.   payment of mailing-costs. No extra charges, apart from mailing-costs, will
  879.   ever be made, not even when the price of BatchReminder should rise.
  880.   You will be contacted by letter in the event of a new major release.
  881.  
  882.   The amount for a single user license is US $ 55.00. For multi-users an
  883.   unlimited site-license can be obtained for US $ 155.00. These amounts
  884.   INCLUDE a US $ 10.00 sur-charge for international bank-transfers.
  885.   A discount of US $ 10.00 therefore will be given if you are sending cash.
  886.  
  887.   For registering BatchReminder you may make use of the form which is
  888.   included in the file REGISTER.DOC
  889.  
  890.   16. What happens if I do not register?
  891.   ──────────────────────────────────────
  892.  
  893.   The try-out version of BatchReminder allows a test period of 30 days.
  894.   After 30 days of use, BatchReminder will ask for registration in batchmode.
  895.   In this stage BatchReminder will continue to operate normally.
  896.   The commercial is merely a reminder that the use of BatchReminder is not
  897.   free.
  898.   When the commercial appears you are granted additional 30 days of use in
  899.   order to enable you to register.
  900.   After 60 days of free use, BatchReminder will no longer work in Batchmode
  901.   and will refuse admittance to its data-files. 
  902.  
  903.   17. Credit where Credit is due
  904.   ───────────────────────────────
  905.  
  906.             Part of this programme is copy-righted by :
  907.             MICROSOFT (R)  - BASIC Professional Development System 7.10
  908.             ASSEMBLER-ROUTINES (Other than BATALARM)
  909.                           - Courtesy of Mr Christy Gemmell, England
  910.             Test-driving :
  911.             Wim de Lange, Aad Hendriks, Ruby Behre, Albert C.F. Stevens
  912.             Henry van den Brink, Arie Bos, Ferry Worung, Jack Lindeboom
  913.  
  914.             Special thanks for relentless testing of BatchAlarm to:
  915.             Albert C.F. Stevens
  916.  
  917.             Design & Programming :
  918.             Ben Kalkhoven h.o. Nice SoftWare!
  919.             Holland, Zoetermeer, January 1994
  920.       
  921.